home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / packages / epic / picman.tex / node8_mn.html < prev    next >
Text File  |  1995-03-15  |  5KB  |  92 lines

  1.  
  2. <H2><A ID="SECTION00035000000000000000">
  3. <TT>\</TT>dashline</A>
  4. </H2>
  5.  
  6. <P>
  7. <#474#><TT>SYNOPSIS:
  8. <BR> \dashline[<#125#><I>stretch</I><#125#>]{<#126#><I>dash-length</I><#126#>}
  9. [<#127#><I>inter-dot-gap for dash</I><#127#>]<tex2html_comment_mark>29
  10. (<I>x</I><SUB>1</SUB>,<I>y</I><SUB>1</SUB>)(<I>x</I><SUB>2</SUB>,<I>y</I><SUB>2</SUB>)...(<I>x</I><SUB>n</SUB>,<I>y</I><SUB>n</SUB>)</TT><#474#><BR>
  11. where <#128#><I>stretch</I><#128#> is an integer between -100 and infinity.
  12.  
  13. <P>
  14. The above command connects the specified points by drawing a dashline
  15. between each pair of coordinates. At least two points must be
  16. specified. A <tex2html_verb_mark>47<tex2html_verb_mark> is a dashed line where each <#129#><I>dash</I><#129#> is
  17. constructed using a <#130#><I>dottedline</I><#130#><tex2html_comment_mark>30
  18. <A NAME="tex2html1" HREF="footnode_mn.html#foot131" TARGET="footer"><SUP>1</SUP></A>.
  19. The dash-length is the length of the <#132#><I>dash</I><#132#> and inter-dot-gap is the gap
  20. between each dot that is used to construct the dash, both in unitlengths.
  21.  
  22. <P>
  23. By default, a solid looking dash is constructed, but by specifying an
  24. inter-dot-gap in the third argument, different looking dashes may be
  25. constructed. With a large inter-dot-gap (about ;SPMgt;0.4mm), each dash will have
  26. the appearance of a little dotted line. One can create a variety of <#133#><I>dashlines</I><#133#> where each <#134#><I>dash</I><#134#> looks different. Here are a few sample
  27. dashlines:
  28.  
  29. <P>
  30. <DIV class="CENTER">
  31. <BR>
  32. <tex2html_image_mark>#picture136#
  33. <BR>
  34. </DIV>
  35.  
  36. <P>
  37. The <#143#><I>stretch</I><#143#> in <tex2html_verb_mark>48<tex2html_verb_mark> is an integer percentage and implies
  38. a certain ``stretch'' for positive values and ``shrink'' for negative
  39. values; it is optional and by default is ``0'' unless the default
  40. itself has been changed (described later). The number ``0'' signifies
  41. that a minimum number of dashes be put such that they are
  42. approximately equally spaced with the empty spaces between them. A
  43. +ve number means increase the number of dashes by <#144#><I>stretch</I><#144#>
  44. percent, and a -ve number means reduce by that percent. By reducing
  45. the number of dashes, the empty space between dashes is stretched
  46. while maintaining the symmetry. The lower limit on <#145#><I>stretch</I><#145#> is
  47. obviously -100 since at less than -100<tex2html_percent_mark> reduction one essentially
  48. gets nothing. On the upper side, the number, theoretically, can be as
  49. large as infinity (barring arithmetic overflows) and the macro does
  50. not check for any upper bound; one should normally not require more
  51. than 100 percent increase (100 <tex2html_verbatim_mark>#math94#⇒ double the number of
  52. dashes) since that would essentially mean a ``solid line'' and it is
  53. more efficient to use the <tex2html_verb_mark>49<tex2html_verb_mark> command for drawing such
  54. lines, as described later.
  55.  
  56. <P>
  57. The idea behind the <#146#><I>stretch</I><#146#> percentage option is that if several
  58. dashed lines of different lengths are being drawn, then all the dashed lines
  59. with the same -ve or +ve <#147#><I>stretch</I><#147#> will have similar visual
  60. appearance, as might be desired if one were plotting a graph --- one would
  61. like a particular ``curve'' to look the same between all the points on that
  62. curve. Also, it can be used to take any corrective actions, if the appearance
  63. of the default dashline does not meet one's approval.
  64.  
  65. <P>
  66. The default <#148#><I>stretch</I><#148#> percentage can be changed by a
  67. <tex2html_verb_mark>50<tex2html_verb_mark> on the parameter<BR><tex2html_verb_mark>51<tex2html_verb_mark> any time and it takes effect immediately. The
  68. argument is the integer percentage increase or reduction that will be
  69. applied to all <tex2html_verb_mark>52<tex2html_verb_mark> commands except the ones in which the
  70. percentage is explicitly given using <tex2html_verb_mark>53<tex2html_verb_mark> optional parameter.
  71. For example, all <#149#><I>dashlines</I><#149#> could be reduced by 50 percent by
  72. putting the following line <#150#><I>before</I><#150#> using any <tex2html_verb_mark>54<tex2html_verb_mark>
  73. command:<BR> <tex2html_verb_mark>56<tex2html_verb_mark>
  74.  
  75. <P>
  76. An explicit argument to the <tex2html_verb_mark>57<tex2html_verb_mark> command in <tex2html_verb_mark>58<tex2html_verb_mark>
  77. overrides any default values, so for instance, after the above declaration,
  78. if a dashline with ``0'' stretch was desired,
  79. then one would simply say:<BR> <tex2html_verb_mark>60<tex2html_verb_mark>
  80.  
  81. <P>
  82. A note about dashlines of small length. All dashlines always have a dash
  83. beginning at the first coordinate and another ending at the second
  84. coordinate, which implies that a minimum of two dashes are plotted. For small
  85. lines (or larger lines with accordingly larger sized dashes) the dash-length
  86. is reduced as much as necessary to meet above conditions; in such cases, if
  87. necessary, the -ve stretch arguments are ignored. Such dashlines
  88. usually do not have an acceptable appearance, and may either be omitted or be
  89. plotted separately as a dottedline or a dashline with a small dash-length.
  90.  
  91. <P>
  92.